All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class com.sun.java.swing.CellRendererPane 

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----com.sun.java.swing.CellRendererPane
public class CellRendererPane
extends Container
implements Accessible
This class is inserted in between cell renderers and the components that use them. It just exists to thwart the repaint() and invalidate() methods which would otherwise propogate up the tree when the renderer was configured. It's used by the implementations of JTable, JTree, and JList. For example, here's how CellRendererPane is used in the code the paints each row in a JList: 
   cellRendererPane = new CellRendererPane();
   ...
   Component rendererComponent = renderer.getListCellRendererComponent();
   renderer.configureListCellRenderer(dataModel.getElementAt(row), row);
   cellRendererPane.paintComponent(g, rendererComponent, this, x, y, w, h);

A renderer component must override isShowing() and unconditionally return true to work correctly because the Swing paint does nothing for components with isShowing false.

Warning: serialized objects of this class will not be compatible with future swing releases. The current serialization support is appropriate for short term storage or RMI between Swing1.0 applications. It will not be possible to load serialized Swing1.0 objects with future releases of Swing. The JDK1.2 release of Swing will be the compatibility baseline for the serialized form of Swing objects.

Variable Index

o accessibleContext

Constructor Index

o CellRendererPane()

Method Index

o addImpl(Component, Object, int)
If the specified component is already a child of this then we don't bother doing anything - stacking order doesn't matter for cell renderer components (CellRendererPane doesn't paint anyway).<
o getAccessibleContext()
Get the AccessibleContext associated with this CellRendererPane
o invalidate()
Overridden to avoid propogating a invalidate up the tree when the cell renderer child is configured.
o paint(Graphics)
Shouldn't be called.
o paintComponent(Graphics, Component, Container, int, int, int, int)
Calls this.paintComponent(g, c, p, x, y, w, h, false).
o paintComponent(Graphics, Component, Container, int, int, int, int, boolean)
Paint a cell renderer component c on graphics object g.
o paintComponent(Graphics, Component, Container, Rectangle)
Calls this.paintComponent() with the rectangles x,y,width,height fields.
o update(Graphics)
Shouldn't be called.

Variables

o accessibleContext 
 protected AccessibleContext accessibleContext

Constructors

o CellRendererPane 
 public CellRendererPane()

Methods

o invalidate 
 public void invalidate()
Overridden to avoid propogating a invalidate up the tree when the cell renderer child is configured.

Overrides:
invalidate in class Container
o paint 
 public void paint(Graphics g)
Shouldn't be called.

Overrides:
paint in class Container
o update 
 public void update(Graphics g)
Shouldn't be called.

Overrides:
update in class Container
o addImpl 
 protected void addImpl(Component x,
                        Object constraints,
                        int index)
If the specified component is already a child of this then we don't bother doing anything - stacking order doesn't matter for cell renderer components (CellRendererPane doesn't paint anyway).<

Overrides:
addImpl in class Container
o paintComponent 
 public void paintComponent(Graphics g,
                            Component c,
                            Container p,
                            int x,
                            int y,
                            int w,
                            int h,
                            boolean shouldValidate)
Paint a cell renderer component c on graphics object g. Before the component is drawn it's reparented to this (if that's neccessary), it's bounds are set to w,h and the graphics object is (effectively) translated to x,y. If it's a JComponent, double buffering is temporarily turned off. After the component is painted it's bounds are reset to -w, -h, 0, 0 so that, if it's the last renderer component painted, it will not start consuming input. The Container p is the component we're actually drawing on, typically it's equal to this.getParent(). If shouldValidate is true the component c will be validated before painted.

o paintComponent 
 public void paintComponent(Graphics g,
                            Component c,
                            Container p,
                            int x,
                            int y,
                            int w,
                            int h)
Calls this.paintComponent(g, c, p, x, y, w, h, false).

o paintComponent 
 public void paintComponent(Graphics g,
                            Component c,
                            Container p,
                            Rectangle r)
Calls this.paintComponent() with the rectangles x,y,width,height fields.

o getAccessibleContext 
 public AccessibleContext getAccessibleContext()
Get the AccessibleContext associated with this CellRendererPane

Returns:
the AccessibleContext of this CellRendererPane 
All Packages  Class Hierarchy  This Package  Previous  Next  Index